home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 21
/
Cream of the Crop 21 (Terry Blount) (October 1996).iso
/
utility
/
cops608.zip
/
COPSINCE.DOC
< prev
next >
Wrap
Text File
|
1996-08-26
|
9KB
|
203 lines
COPSINCE.DOC 1 Revised: 08-25-96
This program looks for all files in a particular subdirectory and copies all new
ones to another subdirectory. It is typically used to make sure you have
backups of files while you're in the middle of doing something to them.
Features:
* You can copy all files updated since a given date or within the last
x-number of days.
* You can specify that newer files be copied regardless of date restriction
as long as the older version already exists in the subdirectory.
* You can define groups of file types, using DOS wildcard specifications
and copy only, say, text files or word processing files.
Specifying parameters:
Parameters for this program can be set in the following ways. The last setting
encountered always wins:
- Read from an *.INI file (see BRUCEINI.DOC file),
- Through the use of an environmental variable (SET COPSINCE=whatever), or
- From the command line (see "Syntax" below)
Defining your own file specifications:
You can create your own file specifications for copying purposes. Typically,
this is done using an *.INI file (see BRUCEINI.DOC file) but it can also be done
from the command line.
These definition specifications are made using the following syntax:
/DEF filetype=filespecs
For example, if you want to specify a new grouping "WP", you can define it to
include something like the following:
/DEF WP=*.WP *.WP5
Up to 20 file specifications can be made for a given group. Your COPSINCE.INI
file can contain up to 10 groupings. Once the group is defined, you can then
specify the name of the group on the command line and those are the files that
will be grabbed. By default, only two file types are defined and you can
override both of these if desired:
/DEF ALL=*.*
/DEF TEXT=*.BAS *.BAT *.BI *.C *.DOC *.H *.REF *.SAS *.SC *.TEK *.TXT
Win95 notice: As with most DOS-based utilities, this program doesn't understand
the weird subdirectories and filenames that are possible under Windows 95.
COPSINCE.DOC 2 Revised: 08-25-96
Syntax:
COPSINCE [ [ /FROM ] from_dir | from_dir\filespec ] [ /TO to_dir ]
[ /COPY date | /COPY -n ] [ /-A ] [ /-R ] [ /CLONE ] [ /-4DOS ]
[ /ALL | /TEXT | /filetype ] [ /DEF filetype=spec [ spec ]... ]
[ /BEEP ] [ /MONO ] [ /Iinitfile | /-I ] [ /? ]
where:
"from_dir" (or "/FROM from_dir") is the subdirectory name in which the source
files are found. Can provide drive and path information if desired. Defaults
to the current subdirectory. Alternatively, you can specify a filespec
including wildcards to limit the activity to one group of files. If you specify
a filespec, it overrides any /ALL, /TEXT, /filetype specifications.
"/TO to_dir" (or just "to_dir") is the destination to which to copy the files.
Can provide drive and path information if desired. Initially defaults to
"/TO=A:\". The equal sign is optional.
"/COPY date" (or "date") specifies the date from which you want all files
copied. Initially defaults to today's date (e.g. "/COPY 06-23-96"). The date
should be in whatever national date format you have set for your computer.
"/COPY -n" (or "-n") says to copy all files updated in the last n-number of
days. Initially defaults to "/COPY -0"; all files created today only.
"/-A" says to copy files only if they are already in the output directory. This
is the opposite of the /A (add) function which is initially the default. "/-A"
used in combination with "/-R" would exclude all files from consideration and is
not allowed.
"/A" copies files even if they do not exist already in the output directory.
Unlike with DOS's REPLACE command, "/A" and "/R" are not mutually exclusive.
"/A" is initially the default.
"/-R" says to copy files only if they do not exist already in the output
directory. This is the opposite of the /R (replace) function which is initially
the default. "/-R" used in combination with "/-A" would exclude all files from
consideration and is not allowed.
"/R" copies files even if they already exist in the output directory. Unless
/CLONE is specified, only files which are newer in the source subdirectory will
be copied. Unlike with DOS's REPLACE command, "/A" and "/R" are not mutually
exclusive. "/R" is initially the default.
"/CLONE" specifies that files should be copied to the output directory even if
the files in the output directory are newer than the ones in the source
directory. "/-CLONE" (the opposite) is initially the default.
"/-CLONE" says to only copy files to output directory if the files in the output
subdirectory are older than those found in the input subdirectory. This is
initially the default.
COPSINCE.DOC 3 Revised: 08-25-96
"/4DOS" says to respect 4DOS conventions vis-a-vis the DESCRIPT.ION file. File
descriptions from the DESCRIPT.ION file in the input path are added to those (if
any) in the DESCRIPT.ION file in the output path. 4DOS is copyrighted by Rex
Conn and JP Software Inc. The COPSINCE program initially determines whether
4DOS is loaded or not and acts appropriately. The "/4DOS" switch says to force
4DOS adherence whether it's loaded or not.
"/-4DOS" says to ignore 4DOS conventions vis-a-vis the DESCRIPT.ION file.
Initially, the conventions are ignored only if 4DOS is not currently loaded.
"/ALL" says to take all files (initially, a file specification of *.*).
"/TEXT" restricts copying to only those files that are known to be straight
ASCII files. Initially, this is defined as any files which meet any of the
following file specifications:
*.BAS *.BAT *.BI *.C *.DOC *.H *.REF *.SAS *.SC *.TEK *.TXT
Initially, the routine grabs the /TEXT specification by default.
"/filetype" allows you to invoke your own file specification. You might want to
have something like /WP (for *.WP *.WP5 etc files) or whatever. You have to
define this filetype using a /DEF filetype statement.
"/DEF filetype=spec [ spec ]" allows you to create your own file specifications.
Typically, this would be specified in your initfile. See "Defining your own
file specifications" above.
"/BEEP" gives you a beep when the program finishes. Initially defaults to
"/-BEEP".
"/-BEEP" does not beep when the program finishes. This is initially the
default.
"/MONO" (or "/-COLOR") does not try to override screen colors. Initially
defaults to "/COLOR".
"/COLOR" (or "/-MONO") allows screen colors to be overridden. This is initially
the default.
"/Iinitfile" says to read an initialization file with the file name "initfile".
The file specification *must* contain a period. Initfiles are described in the
BRUCEINI.DOC file. Initially defaults to "/ICOPSINCE.INI".
"/-I" (or "/INULL") says to skip loading the initialization file.
"/?" or "/HELP" or "HELP" shows you the syntax for the command.
COPSINCE.DOC 4 Revised: 08-25-96
Return codes:
COPSINCE returns the following ERRORLEVEL codes:
0 = no problems
250 = operation aborted by pressing Escape
255 = syntax problems, or /? requested
Author:
This program was written by Bruce Guthrie of Wayne Software. It is free for use
and redistribution provided relevant documentation is kept with the program, no
changes are made to the program or documentation, and it is not bundled with
commercial programs or charged for separately. People who need to bundle it in
for-sale packages must pay a $50 registration fee to "Wayne Software" at the
following address.
Additional information about this and other Wayne Software programs can be found
in the file BRUCEymm.DOC which should be included in the original ZIP file.
("ym